home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d2 / rtclock.arc / RTCLOCK.DOC < prev    next >
Text File  |  1991-09-16  |  6KB  |  141 lines
  1. RTCLOCK, version 1.33, by Michael Conley
  2.          Release date: January 20, 1991
  3.  
  4. UPDATE:
  5.         RTCLOCK version 1.33 now supports direct HEX addressing of non-
  6.         standard COM ports, if required.  See SETUP and SERIAL SETUP
  7.         below for details.
  8.  
  9. PURPOSE:
  10.         RTCLOCK is intended for use on an AT class 286, 386, or 486 machine.
  11.     It will read the real time clock and set the DOS clock from it, 
  12.     or read the DOS clock and set the real time clock from it, or it
  13.     will allow the user to set BOTH the real time clock and the DOS 
  14.     clock from the keyboard.    
  15.  
  16.     If you own the Heathkit "World's Most Accurate Clock" with a
  17.     serial interface, RTCLOCK will allow you to set BOTH your
  18.     real time clock and your DOS clock from WWV, the short-wave
  19.     time data service provided by the U.S. government.
  20.  
  21. OPERATION:
  22.     Five basic commands are supported, which may be entered either
  23.     on the command line or, if no command is specified, from a menu
  24.     within the program.
  25.  
  26.         [R] reads the real time clock, and sets the DOS clock.
  27.  
  28.         [D] reads the DOS clock, and sets the real time clock.
  29.  
  30.         [S] sets BOTH the real time clock and the DOS clock from
  31.         the keyboard.
  32.     
  33.         [W] sets BOTH the real time clock and the DOS clock from
  34.         serial data transmitted by the Heathkit "World's Most 
  35.         Accurate Clock."  Be sure to read SETUP for additional
  36.         configuration required for this option.
  37.  
  38.         [V] views the time data from the Heathkit "World's Most
  39.         Accurate Clock" until a key is pressed.  It does NOT
  40.         alter either of the system clocks.  Be sure to read
  41.         SETUP for additional configuration required for this 
  42.         option.    
  43.  
  44.         [ESC] exits with no changes.
  45. SETUP:
  46.     Commands <R>, <D> and <S> require NO configuration.
  47.  
  48.     Commands <W> and <V> require the installation of an RS232
  49.     serial line from the Heathkit "World's Most Accurate Clock"
  50.     to the computer.  See the clock manual for wiring information.
  51.     Be sure to set the DIP switch inside the clock for the AUTO
  52.     mode, which provides CONTINUOUS output from the clock.  The
  53.     other mode would require manipulating the DTR line to request
  54.     clock data, and is NOT supported by the program.  Also be sure
  55.     to select an appropriate baud rate and program the correct year
  56.     using the DIP switches inside the clock.
  57.  
  58.     The program must be informed of the baud rate and the COM port
  59.     in either of two ways:
  60.  
  61.     1)  You may invoke the program and provide the configuration info
  62.         on the command line as follows:
  63.  
  64.         RTCLOCK W COM3 2400 [enter]
  65.  
  66.         Allowable choices here are  W or V  for the program mode,
  67.         COM1 thru COM4 for the data port, and 300, 600, 1200, 2400, 
  68.         4800, or 9600 for the baud rate.  Other choices or missing 
  69.         info will produce an error message.
  70.  
  71.             Default COM addresses assumed by the program are:
  72.  
  73.                         COM1  =  H3F8
  74.                         COM2  =  H2F8
  75.                         COM3  =  H3E8 <standards vary ... use custom
  76.                         COM 4 =  H3E0 <addressing if these don't work
  77.                                        for your system -- see below.
  78.  
  79.             If your data port has a non-standard address, you may specify
  80.             the hex port address directly by substituting the following
  81.             command structure:
  82.  
  83.                 RTCLOCK W H2E0 2400 [enter]
  84.  
  85.             The program would then look for a com port at HEX address 2E0
  86.             and attempt to read the clock from that port. 
  87.  
  88.     2)  You may create an ASCII text file (an example is included
  89.         in this distribution) with the port and baud rate on the
  90.             SAME line.  Name this file RTCLOCK.CFG and place it in the
  91.         same directory from which the program will be run.  An 
  92.         example of the file contents would be:
  93.  
  94.         COM3 2400
  95.  
  96.             Note: The parameters must be on the SAME line, and it must
  97.                   be the first line of the file.
  98.  
  99.     Please also note that, if you enter the program with NOTHING on
  100.         the command line (i.e., menu mode) you MUST provide RTCLOCK.CFG
  101.     in order to use the W or V options, as these cannot be entered
  102.         from the menu.  A sample RTCLOCK.CFG is included with this
  103.     distribution.
  104.  
  105. SERIAL SETUP:
  106.     This release supports COM ports 1 thru 4 and functions entirely 
  107.     without interrupts.  This allows you to avoid the common problem 
  108.     of "interrupt sharing," where COM1 and COM3 share IRQ4, while 
  109.         COM2 and COM4 share IRQ3.  Custom addressing is possible by
  110.         specifying the HEX address of your com port instead of the name:
  111.         for example:    RTCLOCK W H2E0 2400 would look for the clock on
  112.         port 2E0 hex.
  113.  
  114.     We recommend that you set your serial I/O card for NO interrupts 
  115.     for the port selected for use with RTCLOCK to avoid possible con-
  116.     flicts with other serial devices.  However, the program will run
  117.     properly even in the event that interrupts are present on the port.
  118.  
  119. CONCLUSION:
  120.     A brief warning:  TEST the clock hookup using a communications
  121.     program, such as Qmodem, to verify that it's hooked up and sending
  122.     data correctly.  RTCLOCK will simply TIME OUT if there is no output
  123.     from the clock in the W or V mode.  
  124.     If the clock IS connected, but it cannot produce the correct time, 
  125.     the program WILL gracefully exit with a message, so it can safely 
  126.     be used in a batch file, provided the serial line is present.
  127.  
  128. PROBLEMS, QUESTIONS, SUGGESTIONS:
  129. =================================
  130. RTCLOCK is public domain.  I don't seek or accept any registration fees for 
  131. this or any of my other public domain utility programs, including those for
  132. Wildcat! BBS systems.  If you're interested in making a charitable contribu-
  133. tion to express your appreciation, please read the enclosed file SHARE for
  134. my thoughts on the subject.
  135.  
  136. I welcome suggestions, and will try to help (no guarantees) if there are
  137. problems.  You may contact me at The Charlatan's Cabin BBS  (213) 654-7337, 
  138. or via CompuServe (70250,220).
  139.  
  140. ============================================================================
  141.